home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 March / EnigmA AMIGA RUN 05 (1996)(G.R. Edizioni)(IT)[!][issue 1996-03][Skylink CD IV].iso / earcd / program / dopeev23.lha / DopeE.doc < prev    next >
Text File  |  1995-08-05  |  14KB  |  314 lines
  1.  
  2.                *********************************************
  3.  
  4.                         DopeE V2.3 by Juan Boulter
  5.  
  6.                 *******************************************
  7.  
  8.  
  9. 26-07-95
  10.  
  11. First of all I would like to thank Wouter van Oortmerssen
  12. for the Amiga E v3.1a Compiler and E programming language on the AMIGA.
  13.  
  14.  
  15. INTRODUCTION
  16. ------------
  17.  
  18. This program was written as an experiment with the E programming
  19. environment. (Actually DopeE is experiment No.3.)
  20. I am slowly teaching myself how to program on the AMIGA.
  21. I believe the AMIGA computer is superior to all others. (But that is just
  22. personal preferance. Some people are severly misled.)
  23. Anyway, please try DopeE and see what you think.
  24.  
  25. I have been toying with the Idea of becoming a well known E programmer
  26. for quite a while now. I quess, ever since the day I found Fish #810
  27. on a CDPD CD.(can't remember which one....) Anyway Amiga E looked like
  28. an easy language to learn so I set to it.(Slowly I might add)
  29.  
  30. As my zest for programming progressed, so too my thirst for an easier
  31. way to do things. I discovered Ez_E by Kevin Connell. My great thanks
  32. to Kevin for helping me with my quest. Unfortunately I have outgrown
  33. Ez_E. I'm sorry Kevin but Ez_E just doesn,t do enough for me anymore.
  34. Hence DopeE(silly name, but thats all I could think of at the time.)
  35. was born. I thought to myself `If I'm going to experiment; why not
  36. create something useful?'
  37.  
  38. REQUIREMENTS
  39. ------------
  40.  
  41. - An Amiga with at least 6 meg ram and a 040 or higher processor.
  42. - About 520 megs of HD space
  43. - Kickstart and WorkBench 3.1
  44.  
  45.  
  46. Nah, just kidding. ;) It should work on any Kickstart 2.0+ Amiga. 
  47. If it doesn't, then please contact me.
  48.  
  49. I have but an A500 with an A590(49meg scsi), 1meg CHIP and 2meg FAST.
  50. A very loyal friend is my Amiga. One day I might get another but never
  51. a replacement.
  52.  
  53. DopeE has also been tested on Geoff Scheiman's A1200 standard with no
  54. adverse effects. (Thank you Geoff....For all your suggestions and advice.)
  55.  
  56. DopeE also requires you to have a few directories assigned.
  57. ie. ESource: EModules: EDocs: EBin: GadToolsBox:
  58. In your Libs: DopeE requires ReqTools.Library 38+ and GadTools.Library 38+
  59. Yes and it would help if you had the Amiga E V3.1a programming package.
  60.  
  61. USAGE
  62. -----
  63.  
  64. DopeE will run by double-clicking on it's icon and will multitask
  65. with the best of them.
  66. DopeE will not however detach if run from a CLI.
  67. The DopeE window has 13 button gadgets and 2 string gadgets. Each gadget
  68. should be fairly self explanitory, but the use of each is as follows:...
  69.  
  70. Source Editor: This will open your editor. It will present you a file requestor,
  71.                and all you need to do is locate your current work file.  It will
  72.                automatically pass the name of this file to your editor. DopeE
  73.                assumes you have an editor named ED in the C: Directory.
  74.  
  75. Compile Source: This button will compile your program. All output from the 
  76.                 compiler will appear in the 'DopeE IO window' so you can see what
  77.                 it is doing.
  78.                 ** Note: that you should have selected a project with editor
  79.                 before using this button, but if you didn't, it will ask you to
  80.                 select a project.
  81.                 ** Note: You can add a command line string in the string gadget
  82.                 to the right of this button. This command line is passed to EC.
  83.                 ** AnotherNote: Pressing the ? button will show you all the
  84.                 arguments that EC will accept.
  85.  
  86. Execute Binary: This will (attempt to) run the program you are currently working
  87.                 on with optional command line arguments.
  88.                 If you have not opened a project with the editor or the compiler
  89.                 button, it will ask you to select a project. Currently opens a
  90.                 small screen window(DopeE Guardian) to run your program in.
  91.                 (Maybe you need a window to pass the odd WriteF() to. I know I do.)
  92.                 ** Note: you can add a command line string in the string gadget to
  93.                 the right of this button. This command line is passed to your
  94.                 program.
  95.  
  96. Bump Revision: This button will give you the choice of either createing a new
  97.                version string, bumping the version # or bumping the revision #.
  98.                In the event that you have not started on a project, DopeE will
  99.                ask you to do so. If you don't have Bumpee in EBin: DopeE will
  100.                ask you to place it there. All output from Bumpee will appear in
  101.                the 'DopeE IO window' so you can see what it is doing.
  102.  
  103. TOOLS: This button launches another bank of buttons that contains a list of
  104.        Useful operations. ie. GadToolsBox,SrcGen,Version,MoveFile,CopyFile,
  105.        RenameFile,DeleteFile and SnoopDos. These buttons will do as you might
  106.        have guessed. I'll explain the four buttons you may not understand.
  107. GadToolsBox: This button will look for GadToolsBox in the GadToolsBox: Directory.
  108.              In the event GadToolsBox is found, It will be run.
  109. SrcGen: This button will bring up a requester for you to choose a .gui file
  110.         generated by GadToolsBox. If SrcGen is found in the EBin: Directory,
  111.         a new E Source will be generated and placed in the ESource Directory
  112.         for you to edit and compile.
  113. Version: This gadget will look for Version in the C: directory. If Version is
  114.          found, you will be presented with a file requestor, and all you need 
  115.          to do is locate the file you require the version of. If no file is
  116.          selected then you will be presented with the Kickstart and Workbench
  117.          version. If Version is not found in C: DopeE will do ask you to place
  118.          it there.
  119. SnoopDos: This gadget will look for SnoopDos in the C: Directory and if
  120.           found will be run. For those of you who know not what SnoopDos is.
  121.           SnoopDos is a very comprehensive system monitor.
  122.  
  123. ShowMod: This will show you the commands available in a particular Emodule.
  124.          It will present you a file requestor, and all you need to do is locate
  125.          the E Module you wish to view. It will automatically pass all infomation
  126.          to the 'DopeE IO window' so you can see what you need to know.
  127.          If you don't have ShowModule in EBin: DopeE will ask you to place it there.
  128.  
  129. ?: This button simply shows you all the arguments that are accepted by EC.
  130.    To understand thier function you should read the Amiga E docs.
  131.  
  132. &: This button will abort the current project. (just in case you decide you
  133.    started on the wrong piece of source code.)
  134.  
  135. FlushMem: This gadget will look for Flush in the C: directory. If found your
  136.           available memory will be flushed. If Flush is not found DopeE will
  137.           do an Avail flush. (I think everybody should have Avail in C:)
  138.  
  139. ClrCache: This gadget will look for FlushCache in the EBin: directory. If found,
  140.           the memory used by EC to hold E's modules, will be flushed. If FlushCache
  141.           is not found DopeE will ask you to place it in EBin:
  142.  
  143. ABOUT: Have a guess......
  144.  
  145. FUNAMBULIST: (What an odd name fo a button.....) This button tries to
  146.              read a configuration file(S:LaunchPro.config). If the
  147.              correct config file exists, you will be presented with a
  148.              button bar consisting of up to 12 buttons. The first two
  149.              buttons are,
  150. Smart: This button is here to do anything the other buttons can not.
  151.        eg. Launch a program, Read a doc etc. On sellection of a file,
  152.        DopeE with endevour to act appropriately. If DopeE has no idea
  153.        what type of file you have selected then you will be asked what 
  154.        you would like to do with the file.
  155.        ie. HexRead?(xMore), Launch?, Listen?(SmartPlay), Hear?(Play16)
  156.        View?(FastView) What happens next is anyones guess???
  157.        (I use external programs like these to reduce the size of DopeE.)
  158. Edit: This button will launch your editor with S:LaunchPro.config so you
  159.       can edit the remaining 10 buttons. Funambulist will support any
  160.       number of buttons from 1 to 10. An example of LaunchPro.config should
  161.       have come with your copy of DopeE V2.3.
  162. Buttons 1 to 10: These buttons will do just what you have told them to do
  163.                  in S:LaunchPro.config
  164.  
  165. E DOCS: If you have assigned EDocs: then this button will use xMore to read
  166.         E.doc. DopeE looks for xMore in C: If xMore is not found in C: then
  167.         DopeE will ask you to place it there.
  168.  
  169. DEBUG: This button will launch EDBG using your current project so you can
  170.        debug your program. If EDBG is not found in EBin: then DopeE will
  171.        ask you to place it there. When I get it to work!!
  172.  
  173.     I strongly advise the use of KingCON by David Larsson. KingCON will
  174.         (apart from other advantages) allow you to retrace the history in DopE IO.
  175.  
  176.      **If you have any problems please don't hesitate to contact me.**
  177.  
  178. EXTRA SOFTWARE (Recommended to enhance the benefit of DopeE.)
  179. --------------
  180.  
  181. Arq V1.83        - By Martin Laubach
  182. AutoCLI V2.53    - By Nic Wilson
  183. FastView V3.0    - By John Hendrix
  184. Flush V2.2ß      - By Conrad Sanderson
  185. KingCON V1.3     - By David Larsson
  186. Play16 V1.5      - By Thomas Wenzel
  187. SmartPlay V3.0   - By Xtreme Intelligence
  188. xMore V1.2       - By Jorma Oksanen
  189. xpkGuide V1.7    - By Simon Dick
  190. MCP V1.04        - By ALiENDESiGN
  191.  
  192.  
  193. HISTORY (begins 29-05-95)
  194. -------
  195.  
  196.     V1.0 - Simply a GUI generated with Srcgen.(Thank you 
  197.     V1.1 - I got the main buttons working corectly.
  198.          ie. Source Editor,Compile Source and Execute Binary.
  199.     V1.2 - It took me a while, but I got Bump Revision to work
  200.          the way I wanted.
  201.     V1.3 - The rest of the buttons were rellatively easy,
  202.          but DEBUG doesn,t work.
  203.     V1.4 - I threw in a few helpful requesters.
  204.     V1.5 - Made DopeE smaller by making some of the code shorter.
  205.          In other words I optomised it a little by way of a more
  206.          prorammer like programming style. DEBUG still doesn,t work.
  207.     V1.6 - The DEBUG button works now!!
  208.   V1.7 - Added the version button.(just a personal thing but you might find
  209.          it useful.) Some other minor tweeking was undertaken just for the
  210.          heck of it.
  211.     V1.8 - Added a new button bar launched from that button I had no use for
  212.          ie. *Juan*.
  213.     V1.9 - Moved the version button to the othe button bar and made the ClrCache
  214.          button.
  215.     V1.10 - I was loosing the current project after using one of my extra tools
  216.          buttons. Took a while but that doesn't happen anymore.
  217.     V1.11 - Added the ? button because I was sick of looking elsewhere.
  218.     V1.12 - I made the Bump Revision button move the module it created to
  219.          the EModules:Bump Directory. Also SrcGen moves the E source it creates
  220.          to the ESource Directory. Saves a lot of time those two little extras.
  221.     V1.13 - I had to make DopeE go to sleep while the othe button bars were
  222.          active, because I found that DopeE still accepted gadget presses and
  223.          they would all happen after the extra button bar was gone. It's even
  224.          got a busy pointer. Oh yer! DopeE handles up to five projects at once.
  225.          I don't know when I did that but there it is.
  226.          Woops...Last minute addition. A random memory display.
  227.     V2.00 - Smart button now recognises .doc, .jpg, .lha, .lzx
  228.          Added a copy .info feature to the copy file button.
  229.          Added a copy over file if file already exists feature to the
  230.          copy file button.
  231.          Added an ask before delete feature to delete file button.
  232.          Fixed a few minor bugs.
  233.     V2.1 - Smart button now recognises .doc, .guide, .jpg, .gif,
  234.          .lha, .lzx, .8svx, .mod
  235.          Added a replace file if file already exists feature to the move file
  236.          button.
  237.     V2.2 - Added an abort current project button.
  238.     V2.3 - Added Funambulist button. (ala QuickLaunch.e distributed with
  239.          Amiga E archive. THANK YOU Wouter.)
  240.          Renamed *Juan* button to TOOLS. (More appropriate, don't you think?)
  241.          Moved smart button to funambulist button bar.
  242.          I finally found out how to use the dos library so now DopeE copies,
  243.          moves, deletes and renames internaly.
  244.          (This was an exciting update.)
  245.  
  246. TODO
  247. ----
  248.  
  249. - Have DopeE detach from a CLI.
  250. - Get the SMART? button to be smarter.
  251.   (Only recognises .doc, .guide, .gif, .8svx, .mod, .jpg, .lha, .lzx
  252.   and executable files)
  253.   Files that require arguments should not be run with the SMART? button
  254.   because there is no output.
  255. - A calculator?
  256. - Additional tools. Maybe we won't need any other programs.....
  257. - Maybe make the code even shorter. (In my dreams!)
  258. - Your suggestions??
  259.  
  260. COPYRIGHT
  261. ---------
  262.  
  263. DopeE is an Anyware program. Maybe someone might like it enough to
  264. send me money?? This not the case I will accknowledge any form of
  265. recognition. A post card, strip-a-gram, slab of beer...........anything!
  266. If you're the author of an shareware program, and you
  267. REALLY want to thank me (can't imagine why...) then send me a
  268. registered version of your program. That's not asking too much, is it?
  269.  
  270. Here I must again impress apon you the fact that I am still just a beginner
  271. at this, so please don't laugh at DopeE. 
  272.  
  273. I can change the name on the *Juan* button for people who register DopeE.
  274. Yes and I will also send updates to registered users.
  275.  
  276. DISCLAIMER
  277. ----------
  278.  
  279. I hold no resposibility for any damage done by DopeE to your computer or
  280. your software. It works fine for me so I thought I'd just share it around.
  281.  
  282. AUTHOR
  283. ------
  284.  
  285. Please Send bug-reports, suggestions, letterbombs(I mean thank-you letters)
  286. to......
  287.  
  288.                               Juan A. Boulter
  289.                              24/176 Whiting st.
  290.                                Labrador 4215
  291.                               Q.L.D. Australia
  292.  
  293.  
  294.  
  295. I can also be contacted via. PARADISE BBS Gold Coast Qld. Australia
  296.                              Ph. No. (07) 55748611
  297. Or maybe just on the AmigaE echo.
  298.  
  299.  
  300.  
  301. And remember: Why buy a PC when you can buy a computer?
  302.  
  303. The AMIGA will never die!
  304.  
  305.  
  306. THANK YOU..... 
  307.  
  308.  Juan Aaron Boulter
  309.  
  310. P.S. I am very proud of this program because it is the first
  311.      I have written that is actually very usefull. (I use DopeE
  312.      to update itself and have done since version 1.1)
  313.  
  314.